Node / meshtastic / Meshtastic-Android / files / .github / agents / speckit.brownfield.validate.agent.md

Displaying Raw • View rendered • Download

---

Tc9d1d9description: Verify bootstrap output matches actual project structure and conventions

Tc9d1d9---

<!-- Extension: brownfield -->

<!-- Config: .specify/extensions/brownfield/ -->

Tc9d1d9# Validate Bootstrap

Verify that the spec-kit configuration generated by Ta5d6ff`/speckit.brownfield.bootstrap` accurately reflects the actual project structure, conventions, and architecture. Reports mismatches and suggests corrections.

Tc9d1d9## User Input

Ta5d6ff```Ta5d6fftext

$ARGUMENTS

Ta5d6ff```

You **MUST** consider the user input before proceeding (if not empty). The user may specify a focus area (e.g., "only constitution", "only templates") or request verbose output.

Tc9d1d9## Prerequisites

Tff7b721. Verify a spec-kit project exists by checking for Ta5d6ff`.specify/` directory

Tff7b722. Verify git is available and the project is a git repository

Tff7b723. Verify at least one bootstrap artifact exists (constitution, customized templates, or AGENTS.md)

Tc9d1d9## Outline

Tff7b721. **Validate constitution**: Check Ta5d6ff`.specify/memory/constitution.md` against the actual codebase:

| Check | How |

|-------|-----|

| **Language references** | Verify mentioned languages actually exist in the codebase |

| **Directory references** | Verify all referenced paths (Ta5d6ff`client/`, Ta5d6ff`server/`, etc.) exist |

| **Framework references** | Verify mentioned frameworks are in dependency files |

| **Naming conventions** | Sample 20 files and check if naming rules match reality |

| **Test location** | Verify test directories mentioned in constitution exist |

| **Branch pattern** | Check if branch naming rules match actual branches in Ta5d6ff`git branch -a` |

Tff7b722. **Validate templates**: Check customized spec/plan/tasks templates:

| Check | How |

|-------|-----|

| **Module references** | Verify template sections reference actual modules/directories |

| **Test commands** | Verify test commands in tasks template actually work |

| **Build commands** | Verify build commands reference real scripts from package files |

| **Section relevance** | Flag template sections that reference non-existent project aspects |

Tff7b723. **Validate AGENTS.md** (if exists): Check agent configuration:

| Check | How |

|-------|-----|

| **Directory ownership** | Verify each agent's directories exist |

| **No overlaps** | Check that no directory is owned by multiple agents |

| **No orphans** | Check that all source directories are covered by at least one agent |

Tff7b724. **Detect drift**: Check if the project has changed since bootstrap:

Tff7b72- New directories or modules added since constitution was generated

Tff7b72- Dependencies added or removed since bootstrap

Tff7b72- New branch patterns that don't match constitution rules

Tff7b725. **Output validation report**:

Ta5d6ff ```Ta5d6ffmarkdown

# Validation Report

## Constitution

| Rule | Status | Detail |

|------|--------|--------|

| Primary language: TypeScript | ✅ Pass | 68% of source files |

| Frontend in Ta5d6ff`client/` | ✅ Pass | Directory exists, contains React code |

| Backend in Ta5d6ff`server/` | ✅ Pass | Directory exists, contains FastAPI code |

| Test location: Ta5d6ff`__tests__/` | ⚠️ Drift | Also found tests in Ta5d6ff`tests/` (not mentioned) |

| Branch pattern: Ta5d6ff`feat/*` | ✅ Pass | 8/10 recent branches match |

## Templates

| Template | Status | Detail |

|----------|--------|--------|

| Spec template | ✅ Pass | All custom sections map to real project aspects |

| Plan template | ⚠️ Drift | References Ta5d6ff`shared/` module — directory renamed to Ta5d6ff`common/` |

| Tasks template | ✅ Pass | Test commands verified |

## Summary

Tff7b72- **Checks passed**: 9/11

Tff7b72- **Drift detected**: 2 items

Tff7b72- **Action needed**: Update plan template (Ta5d6ff`shared/` → Ta5d6ff`common/`), add Ta5d6ff`tests/` to constitution

Ta5d6ff ```

Tc9d1d9## Rules

Tff7b72- **Read-only** — this command never modifies any files

Tff7b72- **Evidence-based** — every pass/fail must cite specific files or directories as evidence

Tff7b72- **Actionable output** — for every failure or drift, suggest the specific fix

Tff7b72- **Non-blocking** — drift warnings don't mean the configuration is broken, just that it could be improved

Tff7b72- **Respect .gitignore** — never scan ignored directories when validating